home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / program / 221 / pascal / pascalm.doc < prev    next >
Encoding:
Text File  |  1988-02-17  |  7.6 KB  |  216 lines
  1.  
  2.  
  3.                      Alternative Personal Pascal Manger
  4.  
  5.                                Jinfu Chen
  6.                                Jan. 1987
  7.  
  8.     1. What is it for
  9.  
  10.         PASCALM is an alternative manager program for OSS Personal Pascal. It
  11. combines the useful features in both Personal Pascal v1.x and v2.0 and has some
  12. more useful features.
  13.  
  14.         Refer to Personal Pascal manual page 2-1(version 2) or page 1-1(version
  15. 1) for further details about manager program.
  16.  
  17.  
  18.  
  19.     2. Installation
  20.  
  21.         Copy PASCALM.PRG and PASCALM.RSC to a disk. The file PASCALM.PRG can be
  22. renamed to whatever name you like, for example, PASCAL.PRG. However, do not
  23. change the name of PASCALM.RSC to anything else except this name.
  24.  
  25.  
  26.  
  27.     3. Using the Manager
  28.  
  29.         Double click PASCALM.PRG from DESKTOP, a title box will appear for
  30. short time and zooming out by itself. The menu has four entries:
  31.  
  32.         Desk   File  Options  Specials
  33.  
  34.         Each entry has more options to be choosed from, see following sections.
  35.  
  36.  
  37.  
  38.     4. Desk menu
  39.  
  40.         This menu has one entry for the program, Pascal Manager, which is a
  41. title box shows version, author name, and copyright notice. Other entries may
  42. exist depending on wether you have any desktop accessory installed.
  43.  
  44.  
  45.  
  46.     5. File menu
  47.  
  48.         This menu has five entries, same as in Personal Pascal. The only excep-
  49. tion is when a TTP (TOS Take Paramter) type program is run, a dialog box will
  50. appear to allow you enter command. Such as running ARC.TTP, one can enter:
  51.  
  52. vh foo.arc
  53.  
  54. to view file information in foo.arc.
  55.  
  56.  
  57.  
  58.     6. Options menu
  59.  
  60.         This menu has four entries:
  61.  
  62.         Compiler Options...
  63.         Linker Options...
  64.         Locate Program...
  65.         Save Options...
  66.  
  67.     6.1 Compiler Options
  68.  
  69.         In the Compiler Options, a box similar to the one in Personal Pascal
  70. version 1.x will appear. Most of them are explained in Personal Pascal manual
  71. (page 2-4 in V2.0, page 3-4). Two options need to be explained here.
  72.  
  73.     No Object Code:
  74.  
  75.         When this option is on, no object file (.O file) is generated. This is
  76. handy for debugging when compiling a program which may contain errors. This is
  77. equivalent to the /NOCODE switch in command line (see Personal Pascal version 2
  78. manual page 8-22).
  79.  
  80.         Note that when this option is on, the 'Chain to linker' option can not
  81. be selected. You will need to toggle off the 'No object code' option before
  82. selecting the 'Chain to linker' option.
  83.  
  84.     Auto backup:
  85.  
  86.         When this option is on, the manager will copy the source file to a path
  87. being defined by the 'Backup Path' box, after the source file being compiled
  88. successfully.
  89.  
  90.         This is very usefull if you are using a RAM disk or hard drive to
  91. program. In such environment, very often programmers rush to run a program
  92. after it is compiled to see if it works, before saving the source file to
  93. a permanent disk or other pertition of the hard drive. If the program crashes,
  94. chances are you will lose the source file, even with some 'reset-proof' RAM
  95. disk. In case of hard drive, if your program trys to write to the disk and mess
  96. up the pertition you are working on it, you will not able to recover the file
  97. also.
  98.         The auto backup path has to be in standard TOS path. For example, these
  99. are legal TOS path:
  100.  
  101.         A:\, A:\SOURCE\, D:\PASCAL\SRC\ARCHIVE\
  102.  
  103.         For users who still using Personal Pascal version 1.x, the temporary
  104. path is not available in this program. However, since you can place all the
  105. overlay programs and libraries in different place, this can be overcome. See
  106. Section 6.3 for information.
  107.  
  108.     6.2 Linker Options
  109.  
  110.         This is very similar to Personal Pascal's, except you can choose the
  111. type of program to be generated. You can choose from GEM, ACC, TOS, or TTP.
  112. Note that the default type is related to the one in Compiler Options so if you
  113. already select GEM in Compiler Options, you do not need to select the one in
  114. Linker Options, and vise versa.
  115.  
  116.         Note that the ACC option in both compiler and linker does not work
  117. under the current version of Personal Pascal compiler (2.00). Consult with OSS
  118. for further information.
  119.  
  120.     6.3 Locate Programs
  121.  
  122.         This is exactly the same as the one in Personal Pascal version 2. You
  123. can tell the manager where is your editor overlay program, or the compiler,
  124. linker, as well as the PASLIB, GEMLIB libraries. This allows you to place files
  125. more flexible and use your favor editor. Caustion should be made if you are
  126. using TOS or TTP type of editor, you will need to name the program extension
  127. properly so that the manager will handle the cursor correctly. For example, the
  128. editor program in Personal Pascal version 1.x is actually a TTP program. It has
  129. to be renamed to EDITOR.TTP and use the 'Locate Programs' option to locate it,
  130. otherwise, a cursor will remain on the screen. GEM type editor can be used as
  131. well, such as 1st Word, or the GEM editor comes with Personal Pascal version 2.
  132.  
  133.         It is recommented use 'Locate Programs' option to find all the files
  134. when first time using the manager and save the options to the .INF file(see
  135. Section 6.4).
  136.  
  137.     6.4 Save Options
  138.  
  139.         This option allows you save all the current configurations to a file
  140. called PASCALM.INF so that when next time the manager program is run, all the
  141. options will be restored. Note that this .INF file has different format from
  142. the PASCAL.INF generated by Personal Pascal Manager, do not just rename the
  143. file.
  144.  
  145.  
  146.  
  147.     7. Specials menu
  148.  
  149.         This menu has quite a few entries related to disk operations. These
  150. include:
  151.  
  152.         Copy Files...
  153.         Create Folder...
  154.         Rename File...
  155.         Disk Space...
  156.         Print Listing...
  157.         Delete File...
  158.         Delete Folder...
  159.  
  160.     7.1 Copy Files
  161.  
  162.         This allows copy file from one disk/folder to anther disk/folder, or
  163. just duplicate the file with different name. A message box will appear on top
  164. of the Item Selector to tell you what file you are selecting for. Error may
  165. occur if you try to copy the file to itself, or disk is write-protected, much
  166. as same as the DESKTOP.
  167.  
  168.     7.2 Create Folder
  169.  
  170.         To be completed.
  171.         Create a folder.
  172.  
  173.     7.3 Rename File
  174.  
  175.         This allows you rename a filename to another. You can even move a file
  176. from one folder to anther by just renaming it, provided it is performed in the
  177. same drive. You can not rename a file from drive A to drive E, for example.
  178.  
  179.     7.4 Disk Space
  180.  
  181.         This allows you check how much free space in a disk drive. A dialog box
  182. will appear first, asking for a disk drive id. Enter the id in UPPER case and
  183. click the OK button or just hit return key, the box will appear again with
  184. information of the disk you request. Error will occur if a non-existent drive
  185. id is enter.
  186.  
  187.     7.5 Print Listing
  188.  
  189.         To be completed.
  190.         This allows you to send a source file to printer. You can choose your
  191. favor printing program to add line numbers or format the file.
  192.  
  193.     7.6 Delete File
  194.  
  195.         Remove a file from the disk. Use with caustion, once it is gone, it is
  196. gone for ever.
  197.  
  198.     7.7 Delete Folder
  199.  
  200.         To be completed.
  201.         Remove a folder from the disk if the folder is empty.
  202.  
  203.  
  204.     8. Conclusion
  205.  
  206.         The manager program has features to help programmers. New features can
  207. be added on request. Bug report and suggestions should be sent to:
  208.  
  209.  
  210.         Jinfu Chen
  211.         445 S. Dobson Rd., #2022             (602)898-5338 (work)
  212.         Mesa, AZ 85202                       (602)834-7061 (home)
  213.  
  214.         CompuServe 72327,2434
  215.         GEnie      J.Chen
  216.